Skip to content

v0.4.1#60

Merged
rktclgh merged 3 commits into
mainfrom
develop
Mar 12, 2026
Merged

v0.4.1#60
rktclgh merged 3 commits into
mainfrom
develop

Conversation

@rktclgh

@rktclgh rktclgh commented Mar 12, 2026

Copy link
Copy Markdown
Owner

📢 기능 설명

필요시 실행결과 스크린샷 첨부

연결된 issue

연결된 issue를 자동으로 닫기 위해 아래 {이슈넘버}를 입력해주세요.

close #{이슈넘버}



🩷 Approve 하기 전 확인해주세요!

  • 리뷰어가 확인해줬으면 하는 사항 적어주세요.
  • [ ]

✅ 체크리스트

  • PR 제목 규칙 잘 지켰는가?
  • 추가/수정사항을 설명하였는가?
  • 이슈넘버를 적었는가?
  • Approve 하기 전 확인 사항 체크했는가?

@coderabbitai

coderabbitai Bot commented Mar 12, 2026

Copy link
Copy Markdown

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: dede7ee6-474f-4c8b-8c7f-9abd682d3fa6

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • 🔍 Trigger review
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment
  • Commit unit tests in branch develop

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@gemini-code-assist

Copy link
Copy Markdown

Summary of Changes

Hello, I'm Gemini Code Assist1! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

이 PR은 AI 면접 질문 생성 시스템의 정확성과 유연성을 향상시키는 데 중점을 둡니다. 한국어 질문의 자연스러운 표현을 더 잘 이해하고 처리할 수 있도록 질문 유효성 검사 로직을 개선했습니다. 또한, 문서에서 질문을 생성할 때 어떤 정보가 더 중요한지 판단하여 우선순위를 부여하는 새로운 정책을 도입하여, AI가 지원자의 핵심 역량과 경험에 초점을 맞춘 질문을 생성하도록 돕습니다. 이는 전반적인 질문 품질을 높이고, 면접 경험을 더욱 효과적으로 만듭니다.

Highlights

  • 질문 유효성 검사 개선: 한국어 면접 질문의 자연스러운 끝맺음(예: '설명해 주세요')을 허용하도록 질문 유효성 검사 로직을 확장했습니다. 이는 interviewQuestionEndings 목록과 hasInterviewQuestionEnding 함수를 통해 구현되었습니다.
  • 문서 질문 검증 결과 상세화: validateGeneratedDocumentQuestions 함수가 이제 DocumentQuestionValidationResult 객체를 반환하여, 유효성 검사를 통과한 질문과 거부된 이유를 명확하게 분리하여 제공합니다.
  • 거부된 질문 로깅 추가: 문서 질문 생성 과정에서 유효성 검사에 실패하여 거부된 질문들에 대한 상세한 로깅이 추가되었습니다. 이를 통해 어떤 이유로 질문이 거부되었는지 쉽게 파악할 수 있습니다.
  • 프롬프트 스니펫 우선순위 지정: 문서 유형(이력서, 자기소개서, 포트폴리오)에 따라 프롬프트 스니펫의 중요도를 평가하고 우선순위를 지정하는 로직이 DocumentQuestionGenerationPolicy에 추가되었습니다. 이를 통해 더 관련성 높은 스니펫이 질문 생성에 활용됩니다.
  • 이력서 프롬프트 예시 구체화: 이력서 관련 프롬프트 예시가 직무 관련 경력, 성과, 기술적 도전 등 더욱 구체적인 내용으로 업데이트되어, AI가 더 정확하고 심층적인 질문을 생성할 수 있도록 돕습니다.

🧠 New Feature in Public Preview: You can now enable Memory to help Gemini Code Assist learn from your team's feedback. This makes future code reviews more consistent and personalized to your project's style. Click here to enable Memory in your admin console.

Changelog
  • src/main/kotlin/com/cw/vlainter/domain/interview/ai/InterviewAiOrchestrator.kt
    • 한국어 면접 질문 끝맺음 목록(interviewQuestionEndings)을 추가했습니다.
    • DocumentQuestionValidationResult 데이터 클래스를 정의했습니다.
    • validateGeneratedDocumentQuestions 함수가 DocumentQuestionValidationResult를 반환하도록 변경하고, 거부된 질문에 대한 로깅을 추가했습니다.
    • 질문 텍스트가 유효한 한국어 면접 질문 끝맺음을 포함하는지 확인하는 hasInterviewQuestionEnding 함수를 추가했습니다.
  • src/main/kotlin/com/cw/vlainter/domain/interview/service/DocumentInterviewService.kt
    • 프롬프트 스니펫 선택 시 DocumentQuestionGenerationPolicy.prioritizeSnippets를 사용하여 우선순위를 적용하도록 변경했습니다.
    • 이력서(FileType.RESUME)에 대한 기본 프롬프트 예시를 더 구체적인 내용으로 업데이트했습니다.
  • src/main/kotlin/com/cw/vlainter/domain/interview/service/DocumentQuestionGenerationPolicy.kt
    • 이력서 역할 신호(resumeRoleSignals), 이력서 노이즈 신호(resumeNoiseSignals), 자기소개서 열망 신호(introduceAspirationSignals) 목록을 추가했습니다.
    • 스니펫 목록을 우선순위에 따라 정렬하는 prioritizeSnippets 함수를 추가했습니다.
    • 문서 유형과 스니펫 내용에 따라 점수를 계산하는 promptSnippetScore 함수를 구현했습니다.
  • src/test/kotlin/com/cw/vlainter/domain/interview/ai/InterviewAiOrchestratorTests.kt
    • 한국어 면접 질문 끝맺음이 허용되는지 확인하는 테스트 케이스를 추가했습니다.
  • src/test/kotlin/com/cw/vlainter/domain/interview/service/DocumentQuestionGenerationPolicyTests.kt
    • 이력서 스니펫 우선순위가 경력과 수상 경험을 과목표보다 앞세우는지 확인하는 테스트 케이스를 추가했습니다.
Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point by creating a comment using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands on the current page.

Feature Command Description
Code Review /gemini review Performs a code review for the current pull request in its current state.
Pull Request Summary /gemini summary Provides a summary of the current pull request in its current state.
Comment @gemini-code-assist Responds in comments when explicitly tagged, both in pull request comments and review comments.
Help /gemini help Displays a list of available commands.

Customization

To customize Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for GitHub and other Google products, sign up here.

You can also get AI-powered code generation, chat, as well as code reviews directly in the IDE at no cost with the Gemini Code Assist IDE Extension.

Footnotes

  1. Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution.

@gemini-code-assist gemini-code-assist Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

이번 PR은 문서 기반 면접 질문 생성 기능을 크게 개선했습니다. 주요 변경 사항은 다음과 같습니다:

  • 문서 스니펫의 우선순위를 정하는 새로운 점수 정책을 도입하여 AI가 생성하는 질문의 품질을 향상시켰습니다.
  • 생성된 질문에 대한 검증 로직을 강화하여, 물음표 외에 더 자연스러운 한국어 질문 종결 어미를 지원합니다.
  • 질문 검증 과정에서 거절 사유를 수집하고 요약하여 로깅함으로써, 모니터링과 디버깅에 큰 도움이 될 것입니다.

코드는 잘 구조화되어 있으며, 새로운 기능에 대한 테스트도 추가되었습니다. 유지보수성 향상을 위해 한 가지 제안 사항이 있습니다.

Comment on lines +170 to +192
private fun promptSnippetScore(fileType: FileType, snippet: String): Int {
val lowered = snippet.lowercase()
return when (fileType) {
FileType.RESUME -> {
val signalHits = resumeRoleSignals.count { lowered.contains(it) } * 18
val noiseHits = resumeNoiseSignals.count { lowered.contains(it) } * 16
val numberBonus = if (Regex("""\d+[%건명배회]""").containsMatchIn(snippet)) 12 else 0
val lengthBonus = min(20, snippet.length / 40)
signalHits + numberBonus + lengthBonus - noiseHits
}
FileType.INTRODUCE -> {
val signalHits = resumeRoleSignals.count { lowered.contains(it) } * 10
val aspirationHits = introduceAspirationSignals.count { lowered.contains(it) } * 14
signalHits + aspirationHits + min(16, snippet.length / 50)
}
FileType.PORTFOLIO -> {
val signalHits = resumeRoleSignals.count { lowered.contains(it) } * 15
val numberBonus = if (Regex("""\d+[%건명배회]""").containsMatchIn(snippet)) 10 else 0
signalHits + numberBonus + min(18, snippet.length / 45)
}
FileType.PROFILE_IMAGE -> snippet.length / 10
}
}

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

promptSnippetScore 함수 내에 가독성과 유지보수성을 저해할 수 있는 여러 매직 넘버(magic number)가 사용되었습니다. 각 숫자의 의미를 명확히 하고 향후 가중치 튜닝을 용이하게 하기 위해, 이 값들을 의미 있는 이름의 지역 상수로 선언하는 것을 권장합니다.

    private fun promptSnippetScore(fileType: FileType, snippet: String): Int {
        val lowered = snippet.lowercase()
        return when (fileType) {
            FileType.RESUME -> {
                val signalWeight = 18
                val noiseWeight = 16
                val numberBonusValue = 12
                val maxLengthBonus = 20
                val lengthBonusDivisor = 40

                val signalHits = resumeRoleSignals.count { lowered.contains(it) } * signalWeight
                val noiseHits = resumeNoiseSignals.count { lowered.contains(it) } * noiseWeight
                val numberBonus = if (Regex("""\d+[%건명배회]""").containsMatchIn(snippet)) numberBonusValue else 0
                val lengthBonus = min(maxLengthBonus, snippet.length / lengthBonusDivisor)
                signalHits + numberBonus + lengthBonus - noiseHits
            }
            FileType.INTRODUCE -> {
                val signalWeight = 10
                val aspirationWeight = 14
                val maxLengthBonus = 16
                val lengthBonusDivisor = 50

                val signalHits = resumeRoleSignals.count { lowered.contains(it) } * signalWeight
                val aspirationHits = introduceAspirationSignals.count { lowered.contains(it) } * aspirationWeight
                signalHits + aspirationHits + min(maxLengthBonus, snippet.length / lengthBonusDivisor)
            }
            FileType.PORTFOLIO -> {
                val signalWeight = 15
                val numberBonusValue = 10
                val maxLengthBonus = 18
                val lengthBonusDivisor = 45

                val signalHits = resumeRoleSignals.count { lowered.contains(it) } * signalWeight
                val numberBonus = if (Regex("""\d+[%건명배회]""").containsMatchIn(snippet)) numberBonusValue else 0
                signalHits + numberBonus + min(maxLengthBonus, snippet.length / lengthBonusDivisor)
            }
            FileType.PROFILE_IMAGE -> {
                val lengthBonusDivisor = 10
                snippet.length / lengthBonusDivisor
            }
        }
    }

@rktclgh rktclgh merged commit 6c14c1b into main Mar 12, 2026
2 checks passed
@github-project-automation github-project-automation Bot moved this from Backlog to Done in Vlainter_BackEnd Mar 12, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Status: Done

Development

Successfully merging this pull request may close these issues.

1 participant